home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCGetUserInfo.z / SCGetUserInfo
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSCCCCGGGGeeeettttUUUUsssseeeerrrrIIIInnnnffffoooo((((3333))))                 IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                  SSSSCCCCGGGGeeeettttUUUUsssseeeerrrrIIIInnnnffffoooo((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SCGetUserInfo - Get information about who is using a scanner
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccaaaannnnnnnneeeerrrr....hhhh>>>>
  14.  
  15.      iiiinnnntttt SSSSCCCCGGGGeeeettttUUUUsssseeeerrrrIIIInnnnffffoooo((((cccchhhhaaaarrrr ****ssssccccaaaannnnnnnneeeerrrr,,,, cccchhhhaaaarrrr ********llllooooggggiiiinnnn,,,, cccchhhhaaaarrrr ********nnnnaaaammmmeeee,,,,
  16.                        cccchhhhaaaarrrr ********hhhhoooossssttttNNNNaaaammmmeeee))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _S_C_G_e_t_U_s_e_r_I_n_f_o can be used after a call to _S_C_O_p_e_n(3) has failed with
  20.      _S_C_e_r_r_n_o set to EEEEBBBBUUUUSSSSYYYY.  _S_C_G_e_t_U_s_e_r_I_n_f_o returns the login name and the real
  21.      name of the user who has the scanner open, and the host name of machine
  22.      on which the scanner is open.
  23.  
  24.      if _S_C_G_e_t_U_s_e_r_I_n_f_o is called at any time other than right after SSSSCCCCOOOOppppeeeennnn has
  25.      failed with _S_C_e_r_r_n_o set to EEEEBBBBUUUUSSSSYYYY, information about the last person to
  26.      have used the scanner is returned.
  27.  
  28. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  29.      _S_C_G_e_t_U_s_e_r_I_n_f_o returns 0 if it is successful, or -1 if there is an error.
  30.  
  31.      In the event of an error, _S_C_G_e_t_U_s_e_r_I_n_f_o sets _S_C_e_r_r_n_o to indicate the
  32.      reason.
  33.  
  34. EEEEXXXXEEEECCCCUUUUTTTTIIIIOOOONNNN EEEERRRRRRRROOOORRRR CCCCOOOODDDDEEEESSSS
  35.      _S_C_G_e_t_U_s_e_r_I_n_f_o will fail under the following circumstances.
  36.  
  37.      SCENOSCANNER             No such scanner
  38.  
  39.      SCENOSCANNERS            No scanners are installed
  40.  
  41.      SCENOMEM                 Out of memory
  42.  
  43.      SCEDRVMSG                Driver specific error.  _S_C_E_r_r_o_r_S_t_r_i_n_g(3) will
  44.                               return a custom message supplied by the scanner
  45.                               driver
  46.  
  47.      In addition, _S_C_G_e_t_U_s_e_r_I_n_f_o may fail as the result of a failed system
  48.      call, in which case _S_C_e_r_r_n_o will be set to a value from <_s_y_s/_e_r_r_n_o._h>.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      _s_c_a_n_n_e_r_s(1M), _l_i_b_s_c_a_n(3), _S_C_C_l_o_s_e(3), _S_C_G_e_t_S_c_a_n_E_n_t(3).
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.